Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Media Functions / Text Media Handler Functions

SetTextProc

Your application can use the SetTextProc function to specify a customized function that is to be called whenever a text sample is displayed in a movie.

pascal ComponentResult SetTextProc (MediaHandler mh,
                                    TextMediaProcPtr TextProc, 
                                    long refcon);

mh

Indicates the media handler for the text media obtained by the GetMediaHandler function.

TextProc

Points to the address of your customized function.

refcon

Indicates a reference constant that will be passed to your function. Set this parameter to 0 if you don't need it.

The format of your customized text function is

            pascal OSErr MyTextProc (Handle theText, 
                                     Movie theMovie, 
                                     short *displayFlag, 
                                     long refcon);

See "Text Functions" on page 2-342 for details on the parameters.

ERROR CODES

None